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COMPUTER GRAPHICS COLOR MANAGEMENT SYSTEM 

BACKGROUND OF THE INVENTION 

Field of the Invention 

The present invention relates to color computer graphics, more 
5 particularly to color management systems, i.e., systems (typically software) that 
provide for the exchange and use of color information in a computer 
environment in which different devices have different color characteristics. 

State of the Art 

10 As color devices for input and output proliferate, so do the problems of 

moving images between them with good results. Differing device types operate 
in different color spaces. Within those spaces, the colors the devices can 
actually produce constitute differing gamuts, or ranges of colors. Monitors, for 
example, typical display colors as combinations of red, green, and blue, and are 

15 said to work in the RGB color space. Monitors by different manufacturers may 
be capable of displaying different intensities of those three colors, so that even 
though they work in RGB space, their gam.uts may be different. Printers 
typically work with varying intensities of cyan, magenta, yellow, and black, and 
are said to work in the CMYK color space. Print technologies vary drastically, 

20 and the gamut that an ink jet color printer can display may be quite different 

from one based on another technology. A single printer may be able to produce 
different gamuts depending on the paper or ink being used at the time of 
printing. Devices with differing color gamuts cannot reproduce each other's 
colors exactly but shifting the colors of one by a carefully chosen profile may 

25 improve the visual match between them. 

The most obvious difference for many users is between an image as it 
appears on the monitor and as printed by a color printer. Monitor colors are 
additive— adding color moves the image toward white— and are generally more 
vivid. Printed colors are subtractive-adding colors moves the image toward 

30 black or dark gray. Under most viewing conditions, the white of a monitor will 
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appear bluish when compared to a sheet of paper, even though the eye perceives 
both as white when viewed separately. 

A color management system is a system that supports color information 
exchange, color matching, color profile management, and device calibration. 
5 Color management offers the means of transmitting color images and documents 
containing color across local and wide area networks while maintaining the 
fidelity of the colors of the original image or document. 

In January 1993, Apple Computer introduced a color management 
system, ColorSync™ 1.0, in the form of a suite of utilities. The ColorSync 

10 Utilities define a process (the color matching method, or CMM) for matching 
colors between gamuts, and a data structure (the color profile) for holding 
information about the characteristics of a particular gamut. The ColorSync 
Utilities provide a default CMM and a default system color profile for Apple 
monitors. Because the ColorSync Utilities are designed to provide an "open 

15 system" for color management, developers can use an Apple-supplied default 

CMM and color profile, create their own, or obtain them from vendors, and use 
them with the ColorSync Utilities. 

The ColorSync Utilities provide applications with several tools for 
matching colors between devices. These include: a default system color profile 

20 that describes the gamut of the Apple RGB 13 inch monitor, a control panel 
(cdev) interface by which users can set their system profile, a means of 
specifying and obtaining color profiles for other devices, a means of tagging 
pictures with color profiles, a default color matching method, a folder for 
storing color profiles, an open architecture that allows developers to create or 

25 obtain a custom color matching method and associate it with a device profile, 
and the ability to report matching progress to the user. 

The ColorSync Utilities contain high level routines that can query and set 
a color profile, begin and terminate matched drawing, match a picture's colors 
as it is drawn, tag a picture with one or more color profiles, and test whether 

30 colors are in a device's gamut. The ColorSync Utilities also contain low-level 
routines for matching specific lists of colors, matching pixel map colors. 
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monitoring the progress of color matching, and creating a custom color 
matching method. 

Color matching means converting colors between differing color gamuts. 
A color matching method (CMM) implements an algorithm that determines how 
5 to convert the colors. In general, whereas device drivers supply CMMs 

appropriate to their device (since the driver knows the color characteristics of 
the device), applications typically do not need to create CMMs. With 
ColorSync™, device drivers can create their own CMMs, obtain them from 
other vendors, or use the CMM provided as the default by Apple. 

10 Because enumerating all the colors in a gamut is generally impractical, 

the ColorSync Utilities describe a color gamut by a set of characteristics (the 
color profile) that define key parameters, such as the points of purest white and 
black, tonal response curves for primary colors, and the type of CMM for which 
the profile was intended. 

15 Each CMM may offer matching options, so that the user can tailor the 

match depending on the kind of image being processed. Typically, color 
matching alters the colors of an image being transferred from one device to 
another such that the resulting image looks as close to the original as possible. 
A number of methods may be used to alter the colors. 

20 Given two overlapping but non-coincident color gamuts A and B, for 

example, in some circumstances it may be best to only alter the colors of space 
A that do not exist in space B. The advantage is that many colors are exactly 
the same in both images, which may be required when using Pantone™ colors 
to prepare a book for printing, for example. The disadvantage is that the best 

25 mapping of the colors that must change may be the same as existing colors, 

reducing the actual number of colors in the copy. Maintaining the same colors 
wherever possible is called a colorimetric match. 

With realistic, photographic images it may be better to alter all the colors 
of the first space, to move them so that their relative positions are the same 

30 when relocated to the second space. The advantage is that a greater number of 
colors may be preserved, and the relationship between colors is maintained. The 
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disadvantage is that none of the original colors is the same in the copy. Since 
the colors in this case will appear the same to the eye, even though they may 
vary drastically if measured by instrument, this is called a perceptual match, 

A third possibility is to maintain saturation: computer-generated bar 
5 charts, for example, do not require exact matching of the particular hues used; it 
may be more important that the image is vivid so it will project well. 

Applications can set one of three corresponding matching options in a 
source profile header to choose variations on the techniques used for color 
matching. A perceptual match uses the destination white point, maintains 
10 lightness, and is good for real- world images. A colorimetric match uses the 

source white point and is good for spot-color matches. A saturation match uses 
the destination white point, maintains saturation for out-of-gamut colors, and is 
good for charts. 

Colors ync allows multiple data types that have different matching to 
15 exist on the same page. For example, a page might contain a photograph that 

was scanned, some bar charts that were generated with a statistical package, and 
some line art that was generated using spot colors, as shown in Figure L 

When the page is captured as a picture, the data stream will represent 
different matching operations required for proper rendering, as follows: 

20 

// For the photograph // 
PicComment( CMBeginProfile) 

{Contains pr2, a profile which has a device type of 'scnr,' and options 
that indicate perceptual match } 
25 Here matching occurs using the perceptual match option. 

PicComment (CMEndProfile) 

Here any matching occurs using the system and device profiles. 

//For spot color line art// 
30 PicComment (CMBeginProfile) 

{Contains prl, a profile which has device type 'rantr' and options that 
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indicate colorimetric match) 

Since no CMEndProfile picture comment was encountered, matching 
continues using this profile. 

5 

PicComment (CMDisableMatching) 

Here there is no matching and data is passed straight through. 
PicComment (CMEnableMatching) 

Now things are matched using the 'mntr' profile with colorimetric 
10 matching again. 

//For bar chart// 

PicComment (CMBeginProfile) 

- {Contains a profile which has device type 'mntr' and options that 
15 indicates saturation} 

Here matching occurs using the saturation match option. 
PicComment (CMEndProfile) 

Here any matching occurs using the system and device profiles again. 
20 An application or driver sets the options to the values it needs before 

calling ColorSync Utilities' matching functions, or before tagging a picture with 
a color profile (i.e., embedding the color profile in the picture). 

All CMMs are components that a Component Manager of the Macintosh 
system software calls in response to calls of applications or drivers through a 
25 defined application interface (API). A component is a piece of code that 

provides a defined set of services to one or more clients. Applications, system 
extensions, as well as other components can use the services of a component. A 
component typically provides a specific type of service to its clients. For 
example, a component might provide image compression or image 
30 decompression capabilities; an application could call such a component, 

providing the image to compress, and the component could perform the desired 



BNSDOCID: cWO 9531794A1_L> 



wo 95/31794 



PCT/US95/06237 



- 6 - 

operation and return the compressed image to the application. In the case of 
ColorSync, the type of service performed is color matching. An application or 
device driver can call ColorSync, providing an image, a source color profile and 
a destination color profile, and ColorSync will call the appropriate CMM 
5 component to perform color matching or other color management functions and 
return the result (e.g., a color-matched image) to the application or device 
driver. 

Multiple components can provide the same type of service. For example, 
separate components might exist that can compress an image by 20 percent, 40 

10 percent, or 50 percent, with varying degrees of fidelity. Similarly, different 
CMMs may achieve varying degrees of color fidelity. All components of the 
same type must support the same basic interface. This requirement allows an 
application or driver to use the same interface for any given type of component 
and get the same type of service, yet allows applications and drivers to obtain 

15 different levels of service. 

The Component Manager provides access to components and manages 
them by, for example, keeping track of the currently available components and 
routing requests to the appropriate component. The Component Manager 
classifies components by three main criteria: the type of service provided, the 

20 level of service provided, and the component manufacturer. The Component 

Manager uses a component type, consisting of a sequence of four characters, to 
identify the type of service provided by a component. CMMs have a 
component type of CMM ' , In addition, CMMs have a signature. The 
signature of the default CMM is appl ' . Third party CMMs are registered 

25 with Apple and assigned a CMM signature. 

The Component Manager provides services that allow applications to 
obtain run-time location of and access to functional objects by creating an 
interface between components and clients. Instead of implementing support for 
a particular data format, protocol, or model of a device, a standard interface is 

30 used through which an application can communicate with all components of a 
given type, such as CMMs. The Component Manager may be used to locate 
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and communicate with components of that type. Those components, in turn, 
provide the appropriate services to the client application. 

Given a particular component type, the Component Manager can locate 
and query all components of that type. An application can find out how many 
5 components of a specific type are available and can get further detail about a 
component's capabilities without having to open it first For each component, 
the Component Manager keeps track of many characteristics, including its name, 
icon, and information string, which may contain any arbitrary information about 
the component. 

10 Components of the type 'CMM' provide color matching services. All 

components of type ' CMM ' share a common application interface, but each 
component may support a unique color matching technique or take advantage of 
a special hardware implementation. Individual components may support 
additions to the defined application interface, as long as they support the 

1 5 common routines any algorithm-dependent or implementation-dependent 
variations of the general interface can be implemented by each 'CMM' 
component as extensions to the basic interface. 

The Component Manager allows a single component to service multiple 
client applications at the same time. Each client application has a unique access 

20 path to the component. These access paths are called component connections. 

A component connection is identified by specifying a component instance. The 
Component Manager provides this component instance to an application when it 
opens a connection to a component. This component maintains separate status 
information for each open connection. 

25 Multiple applications might each open a connection to a color matching 

component. The Component Manager routes each application request to the 
component instance for that connection. Because a component can maintain 
separate storage for each connection, application requests do not interfere with 
each other and each application has full access to the services provided by the 

30 component. Further information concerning component-based design may be 
found in Inside Macintosh, More Macintosh Toolbox. 
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In accordance with the foregoing component-based design, the ColorSync 
Utilities provide a default CMM; developers of device drivers can create or buy 
other CMMs, tailored to the requirements of their devices. 

Referring more particularly to Figure 2, the shaded blocks represent the 
5 color management system, which includes a component based color management 
framework interface, a default CMM, and Apple supplied profiles including a 
default system profile and additional profiles of Apple peripherals. The color 
management system is interoperable with third party CMMs and with third party 
device profiles, which the color management system may use to perform color 
10 matching. The color management system may be called upon by applications 
directly (through a predefined application program interface, or API) to perform 
color matching, or the application may call upon a graphics library or an 
imaging library to perform color-matched services, in which case the graphics 
library or the imaging library will then call upon the color management system 
15 to perform color matching. 

To perform color matching, the ColorSync Utilities use the Component 
Manager to call a color matching method. The actual matching happens inside 
the color matching method component. Figure 3 shows the relationship 
between an application, the ColorSync Utilities, and the color matching 
20 component. 

Device drivers generally provide their own color profiles, and perform 
the match by calling the ColorSync Utilities. This ensures that as new devices 
become available, existing applications continue to receive matched input and 
produce matched output. Applications can print with confidence that the device 
25 driver will produce the best color translation. 

Applications can use color matching to create a print preview dialog, 
showing which colors in the printed image are out of the image gamut as it 
appears on the monitor, for example. Applications that generate images can 
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automatically tag the image with the appropriate profile, or allow the user 
to tag it. 

Color matching always matches the colors of a source profile to the 
colors of a destination profile using a color matching method. The matching 
5 process takes one or more steps, depending on whether the source and 
destination profiles are the same type, and therefore use the same CMM, 

If the source and destination profiles can use the same color matching 
method, the colors are mapped directly from one color gamut to the other. 

If they use different methods, colors are mapped from the source profile 
10 to a profile describing XYZ space, a standard intermediate space, using the 

matching method associated with the source profile. Colors are then mapped 
from XYZ space to the destination profile, using the matching method 
associated with the destination profile. If either the source or the destination 
profile parameter to a matching routine is NIL, the ColorSync Utilities use the 
15 default system profile in its place. 

Figure 4 diagrams the default condition, in which input devices match to 
the system color profile, and output devices match from it to the profile of their 
device. 

In the input matching step, colors are mapped from the device's profile 
20 to the RGB space of the system color profile. In the output matching step, the 
colors are mapped from the system RGB space to the color space of the output 
device. 

Thus, in this default matching case, input drivers match to the system 
profile, and output drivers match from the system profile. Applications work 
25 without modification since the drivers do the matching„ 

Profiles reside in files (usually in a ColorSync™ Profiles folder), with 
device drivers, or in pictures. All ColorSync'^'^ 1.0 profiles have a header, a 
copy of an Apple CMProfileChromaticities record (containing colorant values), 
profile response data for the associated device, and a profile name string for use 
30 in dialog boxes. Custom profiles may also have additional, private data. The 
profile record is diagrammed in Figure 5. 
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The device type field indicates the type of device for which the profile is 
intended. Three standard types are: 
PrinterProfile 'prtr' 
ScannerProfile 'scnr' 
5 MonitorProfile 'mntr' 

The response data fields contain nine curve tables defining device 
gamma values. Seven tables are always filled in; the last two are used only for 
printers using four colors (CMYK). The first table is for grayscale values. The 
next three are red, green, and blue values, followed by three for cyan, magenta, 
and yellow values. Each table includes a count field. The count value specifies 
the number of entries in the curve table except as follows: 

when count is 0, then a linear response (slope equal to 1.0) is assumed, 
when count is 1, then the data entry is interpreted as a simple gamma 
value (ranging from 0 to 8), and 

when count is 3, the entries are interpreted as a gamma-offset-gain 

model. 

The eighth and ninth tables are for CMYK printers and specify 
undercolor removal and black generation data, respectively. Placing a 0 in the 
counts field specifies maximum undercolor removal and maximum black 
generation. 

The name string of the profile is used by the user interface. Applications 
can retrieve ColorSync 1.0 profiles using a GetProfile function. Calibration 
programs can attach a profile to a device using a SetProfile function. Profiles 
can be obtained from currently attached devices that support ColorSync and 
from the ColorSync™ Profiles folder, if present. Profiles can be created by 
hand, or by using a utility such as ProfileMaker. 

The ColorSync Utilities provide an open architecture that can work with 
a variety of color matching methods and color profiles. ColorSync determines 
which CMM to use, based on the CMMType field of the source and destination 
profiles used in a match. (If either profile is missing or NIL, ColorSync uses 
the system profile.) 
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Since any particular configuration may include a variety of input and 
output devices, each with its own CMM and profiles, the ColorSync Utilities 
follow a defined sequence to determine which CMM to use in a given match. 
In the sequence, the default CMM is last in the list, to be used if no other CMM 
5 is specified, or a specified CMM is not available. The process of choosing a 
CMM to perform a match is referred to as CMM arbitration. 

ColorSync™ 1 .0 chooses which CMM to use for a match according to 
this sequence: 

1. If both the source and destination profiles have the same CMMType 
10 and the corresponding CMM component is available then matching is performed 

entirely by that CMM, as shown in Figure 6, where RGB input data is matched 
to CMYK output data, (If the CMM is not available, ColorSync uses the 
default CMM.) 

If the profiles have different CMMType values then ColorSync attempts 
15 the following alternatives in order. 

2. If the CMM for the destination profile is available (and is not 
Apple's) then it is called with the two profiles. If the CMM can match using 
that source profile it returns noErr and matching is performed entirely by the 
CMM corresponding to the destination profile. If a profile error is returned then 

20 alternative 3 is tested. 

The Apple-supplied default CMM will always respond noErr and try to 
perform a match. All profiles must contain the elements necessary for the 
defaiilt CMM. If either the source or destination profile has a CMMType value 
other than 'appl,' that CMM will get a chance to perform the match. The 

25 default CMM is always the last to be chosen, and it always attempts the match 
if asked. 

3. If the CMM for the source profile is available (and it is not the 
default CMM) then it is called with the two profiles. If it can perform the 
match then matching is performed entirely by the CMM named by the source 

30 profile. 
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If the CMM returns an error then the ColorSync Utilities try 
alternative 4. 

4. If the CMMs for both the source profile and destination profile are 
available— but neither can perform the match, as determined by steps 2 and 3— 

5 ColorSync converts the source data from RGB space to XYZ space using the 
source profile and its corresponding CMM. Then ColorSync converts the XYZ 
color space to the destination RGB space using the destination profile and its 
CMM, as shown in Figure 7. 

If this is not possible (one of the CMMs is missing) then alternative 5 is 
10 the fallback. 

5. If one or both of the CMM components corresponding to a profile is 
not available then ColorSync uses the default CMM for that step of the match, 
using the Apple format data required in all ColorSync profiles. 

A CMM must support RGB and CMYK as input color spaces, and RGB, 
15 XYZ, and CMYK as output color spaces. 

In the foregoing CMM arbitration method, the potential exists for some 
CMMs to be unfairly shut out. Since the destination CMM is queried first and 
given first opportunity to perform the color match, the situation may arise in 
which a destination CMM may aggressively respond affirmatively to all queries, 
20 even if it is not the best CMM for the job. 

Furthermore, in ColorSync™ 1 .0, no API support is provided for 
PostScript® conversion. PostScript has established itself as the page description 
LANGUAGE of choice among graphics and pre-press user communities. It is 
also becoming one of the standard imaging models supported on all major 
25 platforms. Integrating color management system functions to support PostScript 
is therefore highly desirable. 

Most high-end printers and image setters have PostScript controllers and 
do not understand any command other than PostScript. To control the color 
output from these devices, PostScript Level 2 defined a device-independent 
30 color mechanism to specify and render color. To integrate color device profiles 
used by color management systems with PostScript devices, conversions have to 
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be done between color profiles and PostScript. 

The main function of a PostScript driver is to convert from the platform 
native graphic format to PostScript for printing. One example of a PostScript 
driver is the PSWriter 8.L It converts Quickdraw format on the Macintosh to 

5 Postscript. In the ColorSync 1.0 system, when a color profile is embedded in 
the document, the driver will convert it into Postscript also. If no profile is 
embedded with the document, the ColorSync System Profile is used. 

The ColorSync 1.0 profile format is extendible, as are some other color 
profile formats. Many profile' vendors therefore put custom information in the 

10 private fields of such formats. The custom data provides higher performance 
when used with the preferred CMM. However, the driver does not understand 
how to interpret the custom data and may not have access to the preferred 
CMM. As a result, the quality of the output from the Postscript devices is less 
than optimal. 

15 ColorSync™ 1.0 makes no provision for profile validation to determine 

whether or not a profile contains all of the required fields. Using profiles that 
do not contain all of the required fields may have a range of effects from mild 
(improper matching) to severe (causing a system crash). 

ColorSync^^ 1.0 provides only limited support for concatenation profiles 

20 in which a transformation is calculated from a sequence of profiles (for a print 
preview operation, for example, from monitor device space to printer device 
space and back to monitor device space). In ColorSync™ 1.0, concatenation 
profiles cannot be saved for future use or embedded in images. 

Moreover, in ColorSync™ 1.0, the profile format is memory resident. 

25 Such a profile format does not readily lend itself to extension and improvements 
without creating a memory burden on the host system. 

SUMMARY OF THE INVENTION 
The present invention, generally speaking, provides in an 
operating-system-level color management system a scalable, flexible and 
30 extensible solution to managing color in color computer graphics systems. A 
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disk -based, tagged-element structure allows selective access to profile data. The 
color management system dynamically arbitrates and dispatches to color 
matching modules (CMMs) and other code modules to perform color 
management functions such as color matching, color space conversion, profile 
5 management, profile file and element access, profile validation, and converting 
profiles to PostScript. A CMM arbitration method ensures fairness for both 
source and destination profiles. 



BRIEF DESCRIPTION OF THE DRAWING 
The present invention may be further understood from the following 
10 description in conjunction with the appended drawing. In the drawing: 

Figure 1 shows an example of a page containing a scanned photograph, a 
bar chart generated with a statistical package, and line art generated using spot 
colors; 

Figure 2 is a block diagram showing the architecture of a known color 
15 management system; 

Figure 3 shows the relationship between an application, the ColorSync 
Utilities, and the color matching component in the color management system of 
Figure 2; 

Figure 4 diagrams a default matching condition in the color management 
20 system of Figure 2, in which input devices match to the system color profile, 
and output devices match from it to the profile of their device; 

Figure 5 is a diagram of a ColorSync™ LO profile record; 

Figure 6 illustrates a case in which, in the color management system of 
Figure 2, matching is performed entirely by a single CMM where both the 
25 source and destination profiles have the same CMMType and the corresponding 
CMM component is available; 

Figure 7 illustrates the case in which, in the color management system of 
Figure 2, ColorSync first converts the source data from the source space to XYZ 
space using the source profile and its corresponding CMM and then converts the 
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XYZ color space to the destination space using the destination profile and its 
CMM; 

Figure 8 is a functional block diagram of the color managenient system 
of the present invention; and 
5 Figure 9 is a diagram of a color profile format in accordance with the 

present invention. 

DETAILED DESCRIPTION OF THE PREFERRED EMBODIMENTS 
Referring to Figure 8, the present color management system architecture 
is divided into five parts: 1) a memory-resident dispatcher, 2) profile 

10 management functions, 3) color space conversion functions, 4) color 

management methods (CMMs), and 5) a standard cross-platform color profile 
format. The memory-resident dispatcher, profile management functions, color 
space conversion functions,color management methods and color profiles are 
identified in Figure 8 by reference numerals 10, 22, 30, 40 and 50, respectively, 

15 The profile management, color space conversion, and color management 

functions are all implemented using the Component Manager 60. Components 
are dynamically dispatched on demand. In addition, the Component Manager 
provides database facilities to track each component in the system, allowing the 
resident dispatcher 10 to call the appropriate component. 

20 The resident dispatcher provides the overall color management 

administrative framework and manages the interaction between the application, 
the various color management pieces, and the actual color image. Typically, the 
dispatcher receives input from the application, analyzes the current profiles and 
passes the image and profile data to the appropriate CMMs to perform the 

25 actual color transformation. Each profile contains information on the preferred 
CMM for that particular profile. An arbitration scheme within the dispatcher 
determines which CMM has precedence in the transformation process. In 
addition to this primary function, the dispatcher calls the appropriate color 
conversion methods when there exists a mismatch between profile interchange 
30 spaces. 
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On the Macintosh computer system, the color management system 
consists of an Extension file from which the resident dispatcher is installed at 
system startup. A separate Control Panel file provides user control of the 
ColorSync System Profile. The color management system relies on the 
5 Component Manager for the basis of the framework which allows plug-and-play 
capability for third party color-matching implementations. 

On 680X0 Macintoshes, the dispatcher is implemented using the Toolbox 
A-trap mechanism. The interface defines the value for register DO at the time a 
function is called. A selector is in the low 1 6 bits and the parameter size is in 
10 the high 16 bits. The functions use pascal stack-based calling conventions. The 
color management system implements a 680X0 mainline function which 
internally dispatches individual calls on the selector. 

On other computer systems, the specific implementation of the dispatcher 
will var>^ 

15 Device profiles provide color management systems necessary information 

to convert color data between native device color spaces and device independent 
color spaces. In the present color management system, color devices are divided 
into three broad classifications: input devices, display devices and output 
devices. For each device class, a series of base algorithmic models are 

20 described which performs the transformation between color spaces. These 

models provide a range of color quality and performance results. Each of the 
base models provides different trade-offs in memory footprint, performance and 
. image quality. The necessary parameter data to implement these models is 
contained in the required portions of the appropriate device profile descriptions. 

25 This required data provides the necessary information for the color management 
framework default color management module (CMM) to transform color 
information between native device color spaces. 

Selecting an appropriate color matching module to perform a color 
matching operation is referred to as CMM arbitration. As compared to 

30 ColorSync 1 .0, the present color management system uses a more efficient 
arbitration scheme, as follows: 
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1 . If both the source and destination profiles have the same CMMType 
and the corresponding CMM component is available then matching is performed 
entirely by that CMM. If the CMM is not available, the color management 
system uses the default CMM. 
5 2. If either source or destination CMM is not available, that CMM is 

replaced with the default CMM. If both the source and the destination CMMs 
are not available, the color management system uses the default CMM and the 
matching is performed entirely by the default CMM. 

3. A concatenated transformation table is built by either the dispatcher 
10 of the default CMM sampling the source data space and converting the sampled 

color points into destination data space using source and destination CMMs. 
This is done by first converting the source data to the interchange space data 
using the source CMM, then converting between interchange spaces from source 
profile to destination profiles, if different, using the color space conversion 
15 functions, and finally converting from the interchange data space to the 
destination data space using the destination CMM. 

4. Colors are converted from source to destination data spaces by doing 
a table look up using the transformation table built in Step 3. 

This improved scheme provides the most flexible CMM arbitration by 
20 giving the preferred CMM first chance to convert between device space and 

interchange space, while improving the performance by building a concatenated 
transformation table. This arbitration scheme also avoids the possible 
domination of destination CMMs by always answering yes when queried 
concerning the ability to perform a matching operation. 

25 Referring to Figure 9, the profile structure, rather than being 

memory-resident, is defined as a series of tagged elements that can be accessed 
randomly and individually. The collection of tagged elements provides three 
levels of information: required data, optional data and private data. A tag data 
header provides a table of contents for the tagging information in each 

30 individual profile. The header includes a tag signature and the beginning 
address offset and size of the tag for each individual tagged element. This 
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tagging scheme allows the tag data header to be read in, after which the 
information necessary for a current software application may be randomly 
accessed and loaded into memory. Since some instances of profiles can be quite 
large, this arrangement provides significant savings in performance and memory. 
5 The required tags provide the complete set of information necessary for 

the default CMM to translate color information between the color interchange 
space and the native device space. A default modeling method for each device 
class determines which combination of tags is required. For example, a multi- 
dimensional lookup table is required for output devices, but not for display 
10 devices. 

A number of optional tags are defined that can be used for enhanced 
color transformations, including tags that support PostScript Level 2 and 
calibration, among others. 

Private data tags allow CMM developers to add proprietary value to their 
15 profiles. Private data tags allows developers to maintain proprietary advantages 
without sacrificing compatibility. 

Referring still to Figure 9, the header provides a set of parameters at the 
beginning of the profile format. In a preferred embodiment, the header is 
fixed-length (128 bytes) and contains the following information: 
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bvtefs) 


content 


0-3 


Profile size. 


4-7 


Identifies the preferred CMM to be used. 


8-11 


Profile version number. 


12-15 


Profile/Device class. 


16-19 


Color space of data (possibly a derived space) [i.e., 
"the canonical input space"]. 


20-23 


Interchange color space [i.e,, "the canonical output 
space"]. 


24-35 


Date and time this profile v^as first created. 


36-39 


'acsp' (0x61637370) profile file signature 


40-43 


Primary platform target for the profile. 


A A A1 


ir^iags lo inQjcaie various opuons lor ine i-.ivi,ivi sucn 
as distributed processing and caching options. 


AQ. <:i 


jL/evice monuiacLurer or tne uevicc lor wnicn mis 
profile is created. 


52-55 


Device model of the device for which this profile is 
created. 


56-63 


Device attributes unique to the particular device setup 
such as media type. 


64-67 


Specifies the rendering intent of this profile for the 
CMM. Photographic, spot colors and business 
graphics are the three intents required to be supported 
v^ith default values of 0, 1 and 2 respectively. 


68-79 


The relative XYZ values of the white point of the 
color space. 


80-91 


The relative XYZ values of the black point of the 
color space. 


92-127 


36 bytes reserved for future expansion. 



In a preferred embodiment, the profile format supports a variety of both 
20 device-dependent and device independent color spaces divided into three basic 

families: 1) CIEXYZ based, 2) RGB based, and 3) CMY based. A subset of the 
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CEEXYZ based spaces are also defined as exchange spaces. Other device 
dependent color spaces may be also used. Any of the defined color spaces may 
be used as a device space, which corresponds to the source or destination color 
space in a color modeling session. 
5 A key component of a color profile is the choice of color interchange 

spaces. These spaces provide the "universal language" with which any number 
of color devices can communicate color information with each other. Most 
color interchange spaces today are based on the CIE 1931 standard observer. 
This experimentally derived standard observer provides a very good 

10 representation of the human visual system's color matching capabilities. Two 
color spaces based on these results have become very popular in color 
management systems: the 1931 CIEXYZ space and the 1976 CIELAB space. 
The CIEXYZ space represents a linear transformation of the derived matching 
responses and the CIELAB space represents a transformation of the CIEXYZ 

15 space into one that is nearly perceptually uniform. This uniformness allows 
color errors to be equally weighted throughout its domain. 

Three color interchange space encodings are supported in the preferred 
embodiment 16 bit per component CIEXYZ, 16 bit per component CIELAB and 
8 bit per component CIELAB. While supporting multiple interchange spaces 

20 increases the complexity of color management, it provides immense flexibility in 
addressing different user requirements such as color accuracy and memory 
footprint. 

The device profiles along with the appropriate device models provide a 
translation mechanism between the native device color space and one of these 
25 three color interchange space encodings. 

The choice of device space and color interchange space is indicated 
within the profile itself as follows: 
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Color Space 


Signature 


XYZData 


•XYZ' 


labData (16 bit per 
component) 


'Lab' 


labSData (8 bit per 
com'Donent^ 


'Lab8' 


luvData 


'Luv' 


YxyData 


'Yxy' 


rgbData 


'RGB' 


grayData 


'GRAY' 


hsvData 


'HSV 


hlsDara 


'HLS' 


cmykData 


'CMYK' 


cmyData 


'CMY' 



15 Requiring tags with profiles is a way to provide a common base level of 

functionality. If a custom CMM is not present, then the default CMM will have 
enough information to adequately model the data. The required data for 
different devices and the particular models implied by the required data are set 
forth in Appendix 1 below. While the required data might not provide the 

20 highest level of quality obtainable with optional data and private data, the data 
provided is adequate for sophisticated device modeling. 

Profiles need to be validated to contain required color information for the 
tagged CMM to use. A ValidateProf lie function is provided to test 
whether a specified profile contains the minimum set of elements^ This function 

25 is dispatched to the CMM specified by the Profile CMMTypeTag element. 
If the CMM is not available then the default Apple CMM is called. Only the 
existence of Prof ile elements is checked. The element content and size are 
not. 

The dispatcher, upon receiving a request to validate a profile, will do the 
30 following steps. 
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1 . Get the name of the preferred CMM from the profile. 

2. If available, dispatch the preferred CMM to do the validation. 

3. If not available, dispatch the default CMM to do the validation. 
Whether or not a tag is required depends on the profile type. Tags that 

5 are required in some profile types may be optional in other profile type. In 
addition, optional tags not generally required in a profile type include the 
follov^ing: 



Tag Name 


General Description 


calibrationDateTimeTag 


Profile calibration date and time 


gcrTag 


Gray component replacement curve 


ucrTag 


Under color removal curve 


charTargetTag 


Characterization target such as IT8/7.2 


luminanceTag 


Absolute luminance for emissive device 


measurementTag 


Alternative measurement specification 
such as a D65 illuminant instead of the 
default D50 


viewingConditionsTag 


Specifies viewing condition parameters 


namedColorTag 


Named color dictionary for converting 
between named color sets and 
interchange spaces 


previewOTag 


Preview transformation: 8 or 16 bit 
data: intent value of 0 


preview 1 Tag 


Preview transformation: 8 or 16 bit 
data: intent value of 1 


preview2Tag 


Preview transformation: 8 or 16 bit 
data: intent value of 2 


monitoringTag 


monitoring attributes such as frequency, 
angle and spot 


deviceMfgDescTag 


displayable description of device 
manufacturer 


deviceModelDescTag 


displayable description of device model 
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technology Tag 


Device technology information such as 
LCD, CRT, Dye Sublimation, etc. 


srcDeviceAttributesTag 


Device attributes for source profile 


srcDeviceModelTag 


Device model designation for source 
profile 


srcManufacturerTag 


Device manufacturer for source profile 


srcDeviceMfgDescTag 


Displayable description of source 
device manufacturer 


srcDeviceModelDescTag 


Displayable description of source 

Hpvipp TYir>H[pl 


srcTechnologyTag 


oourcc uevice lecnnoiogy inioi iiiauon 
such as LCD,CRT, Dye Sublimation, 
etc. 


ps2CRDTag 


PostScript Level 2 color rendering 
dictionary 


ps2CSATag 


PostScript Level 2 color space array 


ps2RenderingIntentTag 


PostScript Level 2 Rendering Intent 



The latter three optional tags (PostScript Level 2 color rendering 
dictionary, PostScript Level 2 color space array, and PostScript Level 2 
Rendering Intent, described in detail in the PostScript Language Reference 
Manual, Second Edition, provide all the necessary information to produce 

15 color-matched output on a PostScript device. Since these tags are optional, 
however, the present color management system provides facilities to derive 
equivalent information from color profiles that do not include them. The 
conversion between color profiles and PostScript is built into the color 
management system, utilizing its modular framework and code resource database 

20 manager (i.e., the Component Manager), 

The color management system, by using the code resource database 
manager, can dynamically dispatch the preferred code module to generate the 
equivalent PostScript for the given color profile. The preferred color conversion 
code module is tagged in the profile. 
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If the preferred color conversion code module is not available, the 
default code module will be invoked to convert the profile into PostScript. In 
this case, only the public profile information is used to generate PostScript. 

There are three functions defined in the color management system API 
5 for requesting conversion of profile data to PostScript. They are: 

•GetPS2ColorSpace - returns 7 bit ASCII or 8 bit binary characters 
usable as the parameter to the PostScript setColorSpace instruction. 

•GetPS2ColorRexideringIntent - returns 7 bit ASCII or 8 bit 
binary characters usable as the parameter to the PostScript 
10 setRenderinglntent instruction. 

♦GetPS2ColorRendering - returns 7 bit ASCII or 8 bit binary 
characters usable as the parameter to the Postscript setColorRendering 
instmction. 

To convert a color profile into PostScript, the driver or application 

15 invokes one of the PostScript functions through the API provided by the color 

management system. The following steps describe the dispatching algorithm: 

color management dispatcher checks the preferred CMM name tagged 
with profile 

check with code module data base manager if the preferred module is 
20 available 

if the preferred module is found 

dispatch the code module with the Postscript API functions 

else 

dispatch the default code module with the Postscript API 

25 functions 

When a CMM is dispatched with the PostScript APIs, it will go through 

the following steps to pass the PostScript equivalent back to the caller: 

validate the color profile 
30 allocate data buffer for transfer 

check if there is PostScript tag included in the profile 
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if found the right tag 

convert the encoding format as requested, if necessary 

stream out the Postscript using the data buffer and the caller 
supplied call back function 

else 

generate the PostScript equivalent with the requested encoding 

format 

stream out the Postscript using the data buffer and the caller 
supplied call back function. 



10 



A matching session typically is set up between two device profiles, a 
source profile and a destination profile. A typical scenario is a graphic designer 
who has created a drawing on a computer monitor using a drawing application. 
The designer will often want to print the design out using a color printer so the 

15 customer can see it. To ensure color fidelity, a matching session is set up with 
the source profile being the display profile for the computer monitor and the 
destination profile being the color printer profile. 

However, since different color devices have different color gamuts, some 
colors on one device may not be reproducible on another. In this case, a color 

20 close to the target will be selected. If the accuracy of the color output is 

critical, the designer may want to do a "preview" of the color output on the 
computer monitor. A matching session with three or more profiles is required 
in order to convert color from display space to printer space and then convert 
back to display space for preview purposes. The process of setting up a 

25 multiple profile matching session and reducing the transformations down to one 
is called profile concatenation. 

To set up a multiple profile matching session, there are two methods that 
the dispatcher can use. 
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Method 1: 

1. Through the color management system application program interface 
(API), an application sets up profile concatenation by providing a list of profiles 
with a "key profile" which indicates the preferred CMM to do the operation. 
5 2. If the key CMM is not available, the default CMM is dispatched to 

do the concatenation. 

3. If the key CMM is available, it will be dispatched to do the 
concatenation. If the key CMM returns an error, then the default CMM is used. 

The second method can be employed by the dispatcher or by the CMMs 
10 to perform profile concatenation. 



Method 2: 

L Through the color management system API, the application sets up 
profile concatenation by providing a list of profiles. 

2. The dispatcher checks if the preferred CMM for each profile in the 
15 list is available. If not, it is replaced with the default CMM. 

3. A concatenated transformation table is built by sampling the source 
data space and converting the sampled color points into destination data space 
using the profiles in the list and CMMs associated with each profile. This is 
done by the following steps: 

20 a. Convert the source data to the interchange space data using the 

source CMM. 

b. Convert between interchange spaces from source profile to the 
next profile, if different, using the color space conversion 

25 functions. 

c. Convert from the interchange space to the device color space 
using the designated CMM. 

30 d. Convert from the device color space to the interchange space 

using the designated CMM. 



e. 



Repeat steps b to d until all the profiles in the list except the last 
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one is exhausted, 

f. Convert from the interchange space to the destination data space 
using the destination CMM. 



4, Colors are converted from source to destination data spaces by doing 
a table look up using the transformation table built in Step 3, 

The concatenated profile can be stored as a special type of profile (called 
a device link profile). If the user establishes a workflow pattern of designing 

10 and proofing documents, a device link profile can be saved to reflect the color 
conversion sequence by the user's workflow. 

Creating a device link profile is very similar to the profile concatenation 
process. Two algorithms can be used by the dispatcher. The only difference 
from profile concatenation is that in step 4, instead of converting colors from 

15 source data space to destination data space, a device link profile is simply 
created with the transformation table stored in it. 

In a preferred embodiment, a device link profile is one of three special 
profiles, or transformations, in addition to the three basic device profile classes 
(input, display and output). These transformations provide a standard 

20 implementation for use by the CMM in general color processing or for the 

convenience of CMMs which may use these types to store calculated transforms. 
These three transformation classes are: device link, color space conversion, and 
abstract transformations. Device link transformations, as previously described, 
provide a mechanism in which to save and store a series of device profiles and 

25 color transformations in a concatenated format. This is extremely useful for 
workflow issues where a combination of devices and transforms are used 
repeatedly. 

Color space conversion transformations are used as a convenient method 
for CMMs to convert between different color spaces. This is particularly useful 
30 if two device profiles support different interchange spaces. Conversions 
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between base color spaces and d&r color spaces are performed with known 
equations. The conversion functic ire implemented in a stand-alone 
Component, making the routines a\>.. .able to the default CMM and to 
third-party CMMs. 

5 Finally, abstract color transformations provide a generic method for users 

to make subjective color changes to images or graphic objects. This 
transformation is encapsulated within a three dimensional table structure to 
provide maximal flexibility. These transforms, set forth in detail in Appendix 2, 
have the following signatures: 
10 ' link' device link transformations, 

' spac ' color space conversion transformations, 

' abst ' abstract transformations- 

The external API implemented by the dispatcher is set forth in 
Appendix 3. 

15 It will be appreciated by those of ordinary skill in the art that the 

invention can be embodied in other specific forms without departing from the 
spirit or essential character thereof. The presently disclosed embodiments are 
therefore considered in all respects to be illustrative and not restrictive. The 
scope of the invention is indicated by the appended claims rather than the 

20 foregoing description, and all changes which come within the meaning and 
range of equivalents thereof are intended to be embraced therein. 
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APPENDIX 1 

LI Input Profile 

This profile represents input devices such as scanners and digital can:ieras. 
LLl Monochrome Input Profiles 



Tag Name 


General Description 


profileDescriptionTag 


Structure containing invariant and localizable versions 
of the profile name for display 


grayTRCTag 


Gray tone reproduction curve 



The mathematical model implied by this data is: 
inrerchange = grayTRC[device} 
This represents a simple tone reproduction curve adequate for most monochrome 
input devices. The interchange values in this equation should represent the achro- 
matic channel of the interchange space. If the inverse of this is desired, then the 
following equation is used: 

device = grayTRCr^[imerchange] 

1.1.2 RGB Input Profiles 



Tag Name | General Description 


profileDescriptionTag 


Structure containing invariant and localizable versions 
of the profile name for display 


redColorantTag 


Red colorant XYZ relative tristimulus values 


greenColorantTag 

blueColorantTag 


Green coloraiit XYZ relative tristimulus values 


Blue colorant XYZ relative tristimulus values 


redTRCTag 


Red channel tone reproduction curve 


greenTRCTag 


Green chaimel tone reproduction curve 


blueTRCTag 


Blue channel tone reproduction curve 
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The forward mathematical model implied by this data is : 



linear^ = redTRC[device,] 
lineara = greenTRC[device^] 
linear^ = blueTRC[devicef,] 
interchange^ redColorant^ 
interchangBy = redColoranty 
interchange^ redColoranty 



greenColorant^ 
greenColoranty 
greenColoTonty 



blueColorant^ 
blueColoranty 
blueColoranty 



linear^ 
linear^ 
linear^ 



This represents a simple linearization followed by a linear mixing model 
The three tone reproduction curves linearize the raw values with respect to the lu- 
minance (Y) dimension of the CIEXYZ interchange space. The 3x3 matrix con- 
verts these linearized values into XYZ values for the CIEXYZ mterchange space. 
The inverse model is given by the foUowing equation. 



linear^ 




linear^ 




linear^ 





redColorantx greenColoranty 
redColoranty greenColoranty 
redColorant2 greenColorantz 
device, ^redTRCr^linear^l 
device^ - greenTRC^linear^l 

device^ = blueTRC^ [linear 



blueColoranty 
blueColoranty 
blueColorantz 



interchangex 
interchangey 
interchange^ 



1.1.3 CMYK Input ProfHes 



Tag Name 


General Description 


profileDescriptionTag 


Structure containing invariant and localizable versions 
of the profile name for display 


AToBOTag 


Device to Interchange space : 8 or 16 bit data 



The AToBOTag represents a device model described by the LutSType or 
Lutl6Types. This tag provides ±e parameter data for an algorithm that includes a 
set of non-interdependent per-channel tone reproduction curves, a three dimension- 
al lookup table and a set of non-interdependent per-channel linearization curves. 
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1.2 Display Profile 

This profile represents display devices such as monitors. 
1.2. 1 Monochrome Display Profiles 



Tag Name 


General Description 


profileDescriptionTag 


Structure containing invariant and localizable versions 
of the profile name for display 


grayTRCTag 


Gray tone reproduction curve 



The tone reproduction curve provides the necessary information to convert between 
a single device channel and the CEXYZ interchange space. 



The mathematical model implied by this data is: 
interchange = grayTRC[device] 
This represents a simple tone reproduction curve adequate for most monochrome 
input devices. The interchange values in this equation should represent the achro- 
matic channel of the interchange space. If the inverse of this is desired, then the 
following equation is used: 

device = grayTRC^\interchange^^ 



L2.2 RGB Display Profiles 



Tag Name 


General Description 


profileDescriptionTag 


Structure containing invariant and locaUzable versions 
of the profile name for display 


redColorantTag 


Relative XYZ values of red phosphor 


greenColorantTag 
blueColorantTag 


Relative XYZ values of green phosphor 


Relative XYZ values of blue phosphor 


redTRCTag 


Red charmel tone reproduction curve 


greenTRCTag 


Green channel tone reproduction curve 


blueTRCTag 


Blue channel tone reproduction curve 



This model is based on a three non-interdependent per-channel tone repro- 
duction curves to convert between linear and non-linear rgb values and a 3x3 matrix 
to convert between linear rgb values and relative XYZ values. The mathematical 
model implied by this data is : 
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linear = redTRC[in^] 
line ar^ = gre en TR C[in^ ] 
linear^ = blueTRClin^^] 



redColorcmt 
redColoranty 
redColorantz 



^ greenColorant^ 
greenColoranty 
greenColorant^ 



blueColorant^ 
blueColoranty 
blueColoranU 



linearj^ 
linearr 



linear: 



This represents a simple linearization followed by a linear mixing model. 
The three tone reproduction curves linearize the raw values with respect to the lu- 
minance (Y) dimension of the CIEXYZ interchange space. The 3x3 matrix con- 
verts these linearized values into XYZ values for the CIEXYZ interchange space. 
The inverse model is given by the following equation. 



linearj^ 




redColorcmt^ 


greenColoranty 


blueColoranty 


-1 


interchange^ 


linear^ 




redColoranty 


greenColoranty 


blueColoranty 




interchangey 


linear^ 




redColoranij^ 


greenColoranty 


blueColorant2^ 




interchange^ 



device^ = redTRC^ [linear p] 
device^ = greenTRC^^ [linear 
device^ -blueTRC^linear^] 

13 Output Profile 

This profile represents output devices such as printers and film recorders. The LUT 
tags that are required by the printer profiles contain either the 8 bit or the 16 bit 
LUTs exclusively as described in the LTJT tags. The bit precision supported must 
be consistent for all of the LUT tags. The LUT algorithm for interchange space to 
device space transformations process data sequentially through a matrix, input ta- 
bles, a color LUT, and output tables. 

L3. 1 Monochrome Output Profiles 



Tag Name 


General Description 


prolSIeDescriptionTag 


Structure containing invariant and localizable versions 
of the profile name for display 


grayTRCTag 


Gray tone reproduction curve 



The tone reproduction curve provides the necessary information to convert between 
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a single device channel and the CIEXYZ interchange space. 

The mathematical model implied by this data is: 
interchange = grayTRCldevice} 
This represents a simple tone reproduction curve adequate for most monochrome 
input devices. The interchange values in this equation should represent the achro- 
matic channel of the interchange space. If the inverse of this is desired, then the 
following equation is used: 

device = grayTRC^[interchange] 

1.3.2 RGB and CMYK Output Profiles 



Tag Name 


General Description 


profileDescriptionTag 


Strucmre containing invariant and iocalizable versions of 
theprofile name for display 


AToBOTag 


Device to Interchange space : 8 or 16 bit data: intent of 0 


BToAOTag 

gamutOTag 


Interchange to Device space : 8 or 16 bit data: intent of 0 


Out of Gamut : 8 or 16 bit data: intent of 0 


AToBlTag 


Device to Interchange space : 8 or 16 bit data: intent of 1 


BToAlTag 


Interchange to Device space : 8 or 16 bit data: intent of 1 


gamutlTag 
AToB2Tag 


Out of Gamut tag : 8 or 16 bit data: intent of i 


Device to Interchange space : 8 or 16 bit data: intent of 2 


BToAlTag 


Interchange to Device space : 8 or 16 bit data: intent of 2 


gamut2Tag 


Out of Gamut tag : 8 or 16 bit data: intent of 2 



These tags represent a device model described by the LutSType or 
Lutl6Types. The intent values described in these tags directly correlate to the value 
of the rendering intent header flag of the source profile in the color modeling ses- 
sion (0 = photographic, 1 = logo color, and 2 = business graphics). In essence, each 
of these tags provides the parameter data for an algorithm that includes a 3x3 ma- 
trix, a set of non-interdependent per-channel tone reproduction curves, a three di- 
mensional lookup table and a set of non-interdependent per-channel linearization 
curves. The algorithmic details of this model and the intent of each tag is given in 
the following sub-section, specifying the general lookup table tag element structure 
for 16-bit data. 

L4 lutl6Type 

This structure converts an 16 bit input color into an 16 bit output color. This type 
contains four processing elements: a 3 by 3 matrix (only used when the input color 
space has three components), a set of one dimensional input lookup tables, a multi- 
dimensional lookup table, and a set of one dimensional output tables. Data is pro- 
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cessed using these elements via the following sequence: 

(matrix) -> (Id input tables) ~> (multidimensional lookup table) -> (Id output ta- 
bles). 









'mfi2* (0x6D667432) type descriptor 


A 1 


r*»Qf*rvprt mu<?t he <>et to 0 


Q 

o 


Number of Input Channels 




"NJnmhf^r of Ontnut Channels 


10 


side) 


11 


Reserved for padding (required to be 0x00) 


12-15 


Encoded eOO parameter 


16-19 


Encoded eOl parameter 


20-23 


Encoded e02 parameter 


24-27 


Encoded e 10 parameter 


28-31 


Encoded ell parameter 


32-35 


Encoded el2 parameter 


36-39 


Encoded e20 parameter 


40-43 


Encoded e2i parameter 


44-45 


Encoded e22 parameter 


46-47 


Number of input table entries 


48-49 


Number of output table entries 


50-n 


input table values 


n+l-m 


GLUT values 


m+l-o 


output table values 



The input, output and GLUT tables are arrays of 16 bit unsigned values. 
Each input table entry is a two byte integer and each table has up to 4096 entries- 
Each input table entry is appropriately normalized to the range 0-65535. The input- 
Table is of size InputChannels * inputTableEntries * 2 bytes. 

The matrix is organized as an 3 by 3 array. The dimension corresponding 
to the matrix rows varies least rapidly and the dimension corresponding to the ma- 
trix columns varies most rapidly and is shown in matrix form below. Each matrix 
entry is a four byte number witii one sign bit, 15 integer bits, and 16 fractional bits. 
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eOO 


eOl 


e02 


elO 


ell 


ell 


e2Q 


e2l 


ell 



When using the matrix of an output profile, and the input data is XYZ, we 

have 







XX 


XY 


XZ 


X 


Y' 




YX 


YY 


YZ 


Y 


r 




zx 


ZY 


ZZ 


Z 



Each input X, Y or Z is an unsigned 1.15 number and each matrix entry is a 
signed 15.16 number. Therefore, each multiplication in the matrix multiply is 1.15 
* S15.16 = sl6.31 and the final sum is also sl6.31. From this sum we take bits 31- 
16 as the unsigned integer result for X', Y', or Z\ These are then used as the inputs 
to the input tables of the multidimensional LUT. This normalization is used since 
the number of fractional bits in the input data must be maintained by the matHx op~ 
eration. 

The matrix is mandated to be an identity matrix for input and display pro- 
files. In addition, the matrix is mandated to be an identity matrix for output profiles 
when the interchange space is CIELAB. 

Each GLUT is organized as an n~dimensional array with a variable number 
of grid points in each dimension, where n is the number of input channels(input ta- 
bles) in the transform. The dimension corresponding to the first input channel var- 
ies least rapidly and the dimension corresponding to the last input channel varies 
most rapidly. Each grid point value contains m two byte integers, where m is the 
number of output functions. The first sequential two byte integer of the entry con- 
tains the function value for the first output fimction, the second sequential two byte 
integer of the entry contains the function value for the second output function, and 
so on until all the output functions have been supplied. The equation for comput- 
ing the size of the GLUT is : 



CLUTsize = LUTDimensions^"^"'''^'''^ • OutputChannels • Ibytes 

The GLUT data must be padded to a 4 byte boundary with zeros at the end 
of the data if necessary. 

Each output table is a two byte integer and has up to 4096 entries. The out- 
putTable is of size OutputChannels * outputTableEntries * 2 bytes. 

When using this type, it is necessary to assign each color space component 
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to an input and output channel. The foUowing table shows these assignments. 1 
channels are numbered according to the order in which their table occurs. Note t 
additional color spaces can be added simply by defining the signature, channel 
signments, and creating the tables. 



Color Space 


Channel 1 


Channel 2 


Channel 3 


Channel 4 


'XYZ' 


X 


Y 


Z 




'Lab' 


L 


a 


b 




'Luv* 


L 


a 


V 




*Yxy' 


Y 


X 


y 




'RGB' 


R 


G 


B 




'GRAY' 


K 








'HSV 


H 


S 


V 




;hls' 


H 


L 


s 




'CMYK' 


C 


M 


Y 


K 


'CMY' 


C 


M 


Y 
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APPENDIX 2 

2. 1 DeviceLink Transf oral 

This transform represents a one-way link or connection between devices. It does 
not represent any device model nor can it be embedded into images. 



Tag Name 


General Description 


profileDescriptionTag 


Structure containing invariant and localizable versions 

of the profile name for display 


AToBOTag 


Acmal transformation parameter strucmre (tiiis is an 
exclusive or) 8 or 16 bit data 


srcDeviceAttribut- 
esTag 

srcBlackPointTag 


Device attributes for source profile 


The relative XYZ values of the black point of the 

source device 


srcDeviceModelTag 


Device model designation for source profile 


srcManufacmrerTag 


Device manufacmrer for source profile 


srcWhitePointTag 


The relative XYZ values of the white point of the 

source de\ice. 



The AToBOTag represents a device model described by the LutSType or 
Lutl6Types. This tag provides the parameter data for an algorithm that includes a 
3x3 matrix, a set of non-interdependent per-channel tone reproduction curves, a 
three dimensional lookup table and a set of non-interdependent per-channel linear- 
ization curves- 



2.2 ColorSpaceConversion Transform 

This transform provides the relevant information to perform a color space transfor- 
mation between die interchange color spaces. It does not represent any device mod- 
el nor can it be embedded into images. 



Tag Name General Description 


profileDescriptionTag 


Structure containing invariant and localizable versions 
of the profile name for display 


BToAOTag 


Inverse transformation parameter stmcture (this is an 
exclusive or) 8 or 16 bit data 


AToBOTag 


Actual transformation parameter stracmre (this is an 
exclusive or) 8 or 16 bit data 
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srcBlackPointTag 


The relative XYZ values of the black point of tlie 
source space. 




The relative XYZ values of the white point of the 
source space. 



The AToBOTag and BToAOTag represent a device model described by the 
LutSType or Lutl6Types. This tag provides the parameter data for an algorithm 
that includes a 3x3 matrix, a set of non-interdependent per-channel tone reproduc- 
tion curves, a three dimensional loolnip table and a set of non-interdependent per- 
channel linearization curves. 



2.3 Abstract Transform 

This transform represents abstract transforms and does not represent any device 
model nor can it be embedded into images. Color transformations using abstract 
profiles are performed within a single interchange space. 



Tag Name 


General Description 


profiieDescriptionTag 


Structure containing invariant and localizable versions 
of the profile name for display 


AToBOTag 


Actual transformation parameter structure (this is an 
exclusive or) 8 or 16 bit data 



The AToBOTag represents a device model described by die LutSType or 
Lutl6Types. This tag provides the parameter data for an algorithm that includes a 
3x3 matrix, a set of non-interdependent per-channel tone reproduction curves, a 
three dimensional lookup table and a set of non-interdependent per-channel Unear- 
ization curves. 
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APPENDIX 3 

Profile File and Element Access 

OpenProfileFile 

Open specifiedcMProf ile file. Return aProf ile reference. The profile file 
is opened with shared read/write permission. 

pascal 
CMError 

OpenProfileFile {Profile *prof, 

const FSSpec *fileSpec) ; 

UpdateProfileFlle 

Rewrite disk file if elements of spectTie^rof ile have been added or 
changed. An error wiU be returned if the profile file is open by another pro- 
gram. 

pascal 
CMError 

UpdateProfileFlle (Profile prof) 
CloseProfile 

Close data file and free memory allocations associated with specifiedro- 
file. Changes to the file are not automatically recorded. SeaJpdatePro- 
fileFile(-.). 

pascal 
CMError 

CloseProfile (Profile prof) 
NdwProftle 

Create new empty Prof ile and associated backing file. TheProf ile must 
be populated and updated by the client program. The default disk file type 
is 'prof. The default profile contents include thecM2Header and an empty 
element table. All fields of diar.M2Header will be set to zeroes excepts ize 
and prof ileVers ion. 

pascal 
CMError 

NewProf ile (Profile *prof, const FSSpec *baclcingF.i leSpec ) 
GopyProflle 

Duplicate aProf ile. Temporary changes which have been made to the 
source Profile are mcluded in targetCMProf ile disk file. 

pascal 
CMError 
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CopyProfile (Profile *profCopy, 

const: FSSpec *copyFileSpec, 
Profile prof) ; 

ValidataProfiie 

Test whether Pro file contains the minimum set of elements. This fixnction 
is dispatched to the CMM specified by theprof iie CMMTypeTag element. 

pascal 
CMError 

ValidateProfile (Prof lie prof. Boolean *valid) ; 
RattonProflle 

Flatten specifiedProf ile to the extemalcMProf iie format A caller sup- 
plied FlattenProcUPP is called to perform the acmal data transfer. The 
flags parameter specifies options for the content of the flattenedMProf iie. 

This function is tised to create an embeddedrMProf iie which can be used 
for graphic documents. The element subset is normally specified by the 
sourceProf Elements flag. The qd32Ki4imi t flag should be used for Quick- 
draw PicCommentS. 

This routine is dispatched to the CMM Component speciSed by th®ro- 
f ile CMMTypeTag element If the CMM is not available then the default Ap- 
ple CMM is called. The default elements are flattened and ±e function 

result is CMMethodNotFound. 

enuin { 

A toBEl emen ts = 1 , 
BtoAElementrs= 2, 
intentO = 4, 

intent 1 = B, 

intent2 = 10, 

qd32KLimit - 20 

}; 



AtoBElementsLiclude elements necessary for the source side of a matching 

session. Common case for a graphic docu- 
ment profile tag. 

BtoAElementsInclude elements necessary for the destination side of a 

matching session. 
intentO Include elements necessary for rendering intent 0. 

intent 1 Include elements necessary for rendering intent 1. 

^^nH Include elements necessary for rendering intent 2. 

qd32KLimit HattenedCHProf ile may not exceed 32K, the limit for 

QuickDraw PicComments. 
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pascal 
CMError 

PlattenProf ile (Prof ile pxof, long flags, FlattenProcUPP 
proc, 

void *refCon) ; 

Parameters 

prof (in) Source Pro file 

flags (in) Specifies options for destinationcMPr o f lie. 
proc (in) Function for data transfer 

refCon (in) Client data which is passed as a parameter to calls tcbroc. 

Result codes 
noErr 

paramErr Result specified by flags is not possible. 

i.e. sourceProfileElements I 
destProfileElements I 
resoIveReferences I 
qd32KLimit 

CMMethodNotFoundCMM Corresponding to Prof ile not available 
System or ColorSync result code if an error occurs 
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UnflattenPmflla 

Ucflatten an external fonnafiriiProf ile to an independent disk file. 
A client-suppIiedFianrenProcUPP is called to perfonn the actual data 
transfer. 

This function may be used to create aprof ile reference from acMProf iie 
embedded in a graphic docmnenL The caller is responsible for calling Open- 
ProfileFile(...) and then clean-up by callingrioseProf ile (.-.) and FSpDe- 
lete (-) when use of the profile is completed. 

This routine is dispatched to the CMM Component specified by th^ro- 
file cMMTypeTag elemenL If the CMM is not available then the default Ap- 
ple CMM is called. The function result in this case will be 

CMMe thodNo tFound. 

pascal 
CMError 

Unf lattenProf ile (rSSpec *resultFileSpec , FlattenProcUPP 
proc, 

void *refCon) ; 

Parameters 

lesultFileSpec (out)Retums profile file spec if function result isioErr or 

CMMethodNo tFound. Otherwise undefined. 

proc (in) Function for data transfer 

refCon (in) Client data which is passed as a parameter to calls tqproc. 

Result codes 
noErr 

CMMethodNotFoundCMM Corresponding to Profile not available 
System or ColorSync result code if an error occurs 
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FlattenProfile(-.) and Unf lattenProf ile («.) USe a caller- supplied 
f lattcnProc function to perform the actual data transfer. Thisf latten- 
Proc function is also a parameter to the PostScript-related utility functions. 
This mechanism allows the caller to control the low level transfer. 

Communication with thef lacrenProc function uses a command parameter. 

enum { 

OpenReadSpool = 1, 
OpenWriteSpool , 
ReadSpool , 
WriteSpool, 
CloseSpool 

1; 

OpenReadSpool Begin the process of readng data. 
OpenWriteSpooIBegin the process of wridng data. 
ReadSpool Read size bytes. 
WriteSpool Write size bytes. 
CloseSpool Finish dara transfer. 

typedef pascal 0S£" ( *FlattenProcPtr) (unsigned char com- 
mand , 

unsigned long 

*size, 

void *d3.ta, void 

*refCon) ; 

#if USESROUTrNKDESCRZPTORS 

typedef UniversalPrccPtrFlattenProcOTP; 

#else 

typedef FlattsnProcPrrF lattenProcUPP ; 
#endif 

Parameters 

C0mmand(in) specifies operation. 

size (iii/out)Specif ies data size on input. 

Returns actual size transferred, 
data (in) Address of buffer. 

refCon (in) Client data which is passed as a parameter to calls to the 

f lattenProc. 
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ProflieElementExIsts 

Test whether an element with specified tag signature is present iffrof iie. 

pasca.1 
CMError 

Prof ileElementZxisrs (Profile prof, OSType tag. 

Boolean * found) ; 

CountProflleEIemonts 

Return one-based count of elements contained iiProf lie. Tags which are 
references are counted as elements. 

pascal 
CMError 

CountProf ileHlener.ns (Prof ile prof, long *elementCount ) 

GetProfileElement 

Get element data for specified tag. The caller is responsible for allocating 
storage. 



pascal 
CMError 

GetProfilsElemenr (Profile prof, OSType tag, 

long * elements ize, void *elementData) ; 

GetProfileHGader 

Get copy of header for the specifiedProf ile. 



pascal 
CMError 

GetProfileHeader (Profile prof, AppleProf ileHeader ^head- 
er) ; 

GetPartialProfilaEiement 

Get part of element data for specified tag. The caller is responsible for allo- 
cating storage. 



pascal 
CMError 

GetPartialProfileElement (Profile prof, OSType tag, 

unsigned long offset, 
unsigned long byteCount, 
void *elementData) ; 



BNSDOCID: <WO 9531794A1 J_> 



wo 95/31794 



PCTAJS95/06237 



-45 - 



SdtProfiieElemantSLzQ 

Reserve size of element data for specified tag. This function must be used 

before callingSetPartrialProf ileElement (-) , 

pascal 
CMError 

SetProf ileElementSize {Prof ile prof, OSType tag, 

unsigned long elementSize) ; 

SatPartialProfiloElement 

Set part of element data for specified tag. 

pascal 
CMError 

SetPartialProfileHiement (Profile prof, OSType tag, 

unsigned long offset, 
unsigned long byteCount, 
void *elementDat:a) ; 

iGidtindeProfileEIemdntlnfo 

Obtain element tag and data size by index in the range of L.elementCount 
(as returned by CountProf ileSlements {-,) ). 



pascal 
CMError 

GetlndProfileElenientlnfo (Profile prof, unsigned long in- 
dex, 

OSType *tag, unsigned long *ele- 

mentSize, 

Boolean *refs> ; 

GetlndProfileEloment 

Get data for element at specified index. Caller is responsible for allocating 
storage. 

pascal 
CMError 

GetlndProf ileElement (Prof ile prof, unsigned long index, 

unsigned long *elementSize, void *el- 

ementData) ; 
SstProfileElement 

Set element data for specified tag. If an element with the specified tag is al- 
ready present in the Prof ile, the existing element data is replaced. 

pascal 
affirror 

SetProfiIeEle2[ien.t (Prof ile prof, OSType tag. 
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imsigned long eleitientSize, void *ele- 

mentDatia) ; 
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SetProflleHeader 

Set header for the specifiedProf iie. 



pascal 
CMError 

SetProflleHeader {Prof ile prof, const AppleProf ileHeader 
♦header) ; 

SetProfileEIementReference 

Add tag to Pro file which references data corresponding to a previously set 
clement. 

After successful completion of this function there wiU be more than one tag 
corresponding to a single piece of data. All of these tags are "equal citizens". 
If setProf ileEiemenu is subsequendy called for one of the common 
tags then the new element data will be "appended" to there file rather 
than replacing the existing data- 
It is possible to set a reference to an element which was originally a refer- 
ence itself without circularity. 

pascal 

CMError 

SetProf lleElementRef erence (Prof ile prof, OSType element- 
Tag, 

OSType ref erenceTag) 

RemovaProfileEIement 

Remove clement with specified tag signature frortProf iie. 

pascal 
CMError 

RemoveProfileEleinent (Prof iie prof, OSType tag) ; 

Low-level Matching 

To use the low level routines you first create a color matching world, or 
eWorld, which establishes how matching will take place between the given 
source and destination profiles. Calling NewColorWorld gives you a color 
matching world and DisposeColorWorld gets rid of it 

You can match individual colors by passing the color and the color match- 
ing world to the matching utilities. Tliis allows you to set up your matching 
parameters one time, do all the matching you want using the color matching 
world, and then clean up. Furthermore, it allows you to send and receive col- 
ors direcdy in XYZ, CMYK, or Gray color spaces rather than just RGB. 
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You can also match an individual pixel map, or determine whether or not a 
list of colors is in ±e gamut of a particular color space. 

NCWNewCoIorWorid 

Set up a matching session forsrc and dst Profiles. The CMM Compo- 
nent(s) involved will fetch theProf ile elements necessary for the matching 
session. 

The src and dst Profiles may be closed with closeProf ile {„) after 
calling this function. 

pascal 
CMError 

NCWNewColorWorId(CTorld *inyCWorld, Profile src. Profile 
dst) ; 

NCWConcatColorWorld 

Set up a session for color processing which includes a set ofprof iies. The 
CMM Component specified by theProfile at ConcatProfileSet. key in- 
dex will fetch the Pro file elements necessary for the session. 

The specifiedPro files may be closed withcioseProf ile («) after caHin^y 
this function. ^ 



pascal 
CMError 

NCWConcatColorWorld (CWorld *inyCWorld, 

ConcatProf ileSet *profileSet) ; 

Parameters 

myCWorld(in/out)Retums reference to session if function result i&aoErr. 

Otherwise undefined. 

profiD[eSet(in) ConcatProf iieSet contains an array of Prof iles which 

describe the processing to be carried out 

Theprof ileSet array is in processing or- 
der — Source through Destination. A mini- 
mum of one Profile is required. 

The CMMType element of Prof ile at key In- 
dex specifies the CMM which is entirely re- 
sponsible for the session. 

struct ConcatProfileSet 
{ 

unsigned shortkeylndex; /* zero- 
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based */ 

unsigned shortcouxit ; 
Profile profileSet [1] ; 

}; 

Result codes 
noErr 

System or ColorSync result code if an error occurs. 

CWNewLinkProffie 

This function allows the creation of a newprof iie which embodies the 
transforms included byNa\rconcatcoiorWorid(-,). 

pascal 
CHError 

CWWewLinkProfile (Prof lie *prof, 

const: FSSpec *backingFileSpec, 
ConcatProf ileSet *prof ileSet) 

Parameters 

myCWorld(in/out)Retunis reference to session if function result isnoErr. 

Otherwise undefined- 

bacMngFaeSpec (in)File spec for the resuitingcMProf iie. 

profileSet(in) ConcatProf ileSet contains an array ofprof iies which 

describe the processing to be carried ouL 

The profileSet array is in processing or- 
der — Source through Destination. A mini- 
miun of one profile is required. 

The CMMType element of Prof ile at keyln- 
dex Specifies the CMM which is entirely re- 
sponsible for the session. 

Result codes 
noErr 

System or ColorSync result code if an error occurs. 



CWDisposaCoIorWorld 

Free private storage associated with acworld. 

pascal 
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void 

CWDisposeColorWorld{CWorld rnyCWorld) ; 
CWMatchColors 

Match colors according to theProf iles corresponding to acworld. On en- 
try» the CMColor values are taken to be tfaedataType of the Source Pro file. 
On exit, thecMCoior values are transformed to the dataType of the Desti- 
nation Profile- 
Matching sessions set up with one of the Multichannel color data types are 
supported with this function. 

pascal 
CHError 

CWMatchColors (C/Jcrld myCWor Id, CMColorList myColors, 
long count) ; 

CWCheckCoIors 

Gamut test colors according to thePro files corresponding to mycworld. 
On entry, ±e CMColor values are taken to be thedataType of the Source 
Profile. The gamut test is a preflight of color-matching with this:world. 
The result bit array indicates whether the colors in the list are in or out of 
gamut for the DestinaiionProf lie. 

Matching sessions set up with one of the Multichannel color data types are 
supported with this funcdon. 

pascal 
CMError 

CWCheckCoIors (eWorld itr^rCWor Id, CMColorList ntyColors, 

unsigned long count, CMGamutResult result) ; 
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CWMatchBitMap 

Match pixel data oflDitMap according to theProf iles corresponding to my- 
CWorld. 



typedef pascal Boolean (*Bit:MapCallBackProcPtr) (long 
progress, 

void *ref- 

Con) ; 

#if USESROtrriNEDESC^irPTORS 

typedef UniversalProcPtr BitMapCallBacklTPP ; 
#else 

typedef BitiMapCallBackProcPtr BitMapCallBaclcUPP; 
#endif 

pascal 
CMError 

CWMatchBitiMap (eWorld myCWorld, const CMBitMap *bitMapr 
BicMapCallBacktJPP progressProc , 
void *refCon, CMBitMap *inatchedBifcMap) ; 

CWCheckBitMap 

Gamut test pixel data ofbicMap according to theProf iles corresponding 
to iciyCWorld. 

pascal 
CMError 

CWCheckBitMap (eWorld nryCWorld, CMBitMap *bitMa.p, 
BitMapCallBackUPP progressProc, 
void *rafCon, 
CMBitMap *resultBitMap) ; 

Quickdraw-speclfic Matching 
CWMatchPlxMap 

Match pixel data ofetyPixMan according to theProf lies corresponding to 
niyCWorld. inyPixMap must be non-relocatable. 

pas cal 
CMError 

CWMatchPixMap (eWorld myCWorld, PixMap *irryPixMap, 

BitMapCallBackUPP progressProc, void ♦ref- 

Con) ; 
CWCheckPixMap 

Gamut-test pixel data o&yPixMap according to theProf iles correspond- 
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ing to mycworld. inyPixMap must be non-relocatable. 

pascal 
CMError 

CWCheckPixMaD (eWorld xnyC^-Jorld, PixMap ^myPxxMap, 

'sitilapCallBackUPP progressProc, void *refCon, 
Bitljlap *resultBitMap) ; 

NBeginMatching 

Set up a high-level matching session forsrc and dst Profiles. 

If the currentGDevice is a monitor device then subsequent Quickdraw op- 
erations to all monitoiGDevices will matched. Otherwise automatic match- 
ing will be limited to ifae currenGDevice. 

pascal 
CMError 

NBeginMatchingi Profile src, Profile dst, CMMatchRef 
*inyRef ) 

EndMatching 

Restore unmatched Quickdraw operations and free private allocations for 
the 

high-level matching session. 

pascal 
void 

EndMatching{CM^^at:c:hHef n^Ref) 

NDrawWIatchedPicture 

Bracket DrawPicture (-) with WhiteFang function caUs which set up and 
take down a high-level matching session. The Picmre will be drawn with 
matched colors to all monitoiGDevices. If the currentGDevice is not a 
monitor Device then matching will occur for thaCDevice only. This func- 
tion and DrawPicture («) operate in the context of the currentrcraf Port. 
Color-matching Picconnnents embedded in the Picture are respected. 

pascal 

void 

NDrawMatchecPiccurs (PicHandle rtryPicture, Profxle dst, 

Rect *iryRect) 

EnabSefJIatching 

Generate acMEnableHatching orcMDisabieMatching PicComment for 
currently open Picmre. 

pascal 
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void 

EnableMat:claing{Boole2SJi enablelt) 
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External Profile Searching 

Seaarh and access functions for?rof iles in the ColorSync™ Profiles folder. On 
the Macintosh this is located in {SysteinFolder}Preferences: Search specifications 
are defined by : 

/■*• Defines fox* version 2.0 Prof ileSearchRecord , sear chMask */ 

#define kMatciiProf ileCMMTypeOxOOOOOOOl 

^define kMafechProfileClass 0x0 00000 02 

tdefine kMatcbDeviceSpaceOxO0000004 

#def ine kMatcb.InterchangeSpaceOx00000008 

#define kMatcbHanuf acrurerOxOOOOOOlO 

tdefine kMatichModel 0x00000020 

#define IcMatcbAtirributes 0x0 0000040 

#de f ine IcMa t chPr o f i 1 eF lags 0x00000080 

typed ef 
pascal 

Boolean (*Profilerilter?roc?tr) (Profile prof , void *refCon) ; 
#if USESROUTIHEDESCRIPTGRS 

typedef UniversalProcPtr Prof ileFilterUPP; 
#else 

typedef Prof ile? iltarProcPtr Prof ileFilterUPP; 
tendif 

struct Prof ileSearchRecord { 
OSType CSi!MType ; 

OSType prof ileClass ; 

OSType deviceColorSpace; 
OSType interchangeColorSpace ; 

unsigned longdeviceManufactur erg- 
ons igned longdeviceHode 1 ; 
unsigned longdeviceAttributes [2 ] ; 
unsigned longprof ileFlags; 

unsigned longs ear cbMask; 
ProfileFilterUPPfilter; 

typedef struct Prof ileSearchRecordProf ileSearchRecord; 

The bits of searchiyiask Specify corresponding fields which must match in the 
search. 

filter is a client function which can be used to search on elements outside the de- 
fined Prof ileSearchRecord fields to implement OR or AND search logic. This 
funcdon renims true if die specified profile is to be filtered from the search. 

The data structure which contains the result of a profile search is a private abstract 
type. 

typedef structPrivateProf ileSearchResult*Prof ileSearcb; 
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The search functions are implemented in a private standalone ComponenL It is reg- 
istered at startup with the following parameters. 



coimonentType 


'prof ' 


coirqponentiSaibTYpe 


*aflf 


conroonen tManuf ac tixrer 





This Component is opened and called by the resident dispatcher to implement die 
WhiieFang APL 
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NewProfiieSdarch 

Description. 

pascal 
CMError 

NewProf ileSear'c:h(Prof ileSearchRecord *searchSpec, 

void *refCon, unsigned long *count:. 
Prof ileSearch *searchResult:) ; 

UpdateProflleSearch 

Update an existing search result This is necessary if the contents of the 
ColorSync'^ ProfiQes folder has changed since the search result was creat- 
ed. 

Sharing a disk over a network makes it possible for the folder contents to be 
modified at any time. 

pascal 
CMError 

trpdateProf ileSearcb. (ProfileSearch search, void *refCon, 

unsigned long * count) 

DesposePrcfilaSearch 

Free private allocations associated with Search result. 

pascal 
void 

DisposeProf ileSearch (Prof ileSearch search) ; 
SearchGetlndexedProfiie 

Open and return reference to theprof iie at index into search restilt. The 
cdler is responsible for closing the retumedProf iie. 

pascal 
CMError 

SearchGetlndexedProfile {ProfileSearch search, unsigned 
long index. 

Profile *prof ) ; 

SearchGetlndexedProflleFileSpGc 

Get file speciScarion for theProf ile at index into search result 

Cross-platform implementations will define th^rof iieFile parameter as 
appropriate to the OS. 

pascal 
CMError 
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SearchGetlndexedProf ileFileSpec (Prof ileSearcii searcii, 

unsigned long index, 
FSSpec *profileFil6) ; 

System Profile Access 

The System Profile represents an abstract device. It is used as the default color 
space if a Profile is not specified for the WhiteFang matching functions- The Sys- 
tem Profile is that of an RGB or GRAY monitor for Color QuickDraw. 

GatSystemProfile 

Return Profile reference for current System Profile. Caller is responsible for 
calling ClosePro file (,.) when&ushed. 

pascal 

CMError 

GetSystemProf ile (Prof ile *prof) ; 

SetSystemProfila 

Set specified profile file as the current System Profile. 

pascal 
CMError 

SetProfile (const FSSpec *prof ileFileSpec) ; 

Utilities 

GatCoforSyncFolderSpec 

Return the HPS volume refNum and directory ID of the ColorSync™ Pro- 
files folder. Optionally create folder if it does not already exist. 

pascal 
CMError 

GetColorSyncFolderSpec (short vRefNum, Boolean createFold- 
er, 

short *foundVEefNum, long *foundDi- 

rlD) ; 
GetCWInfo 

Supply information about an existing CWorld. The information is renimed 
in the caUer's CWInfoRecord structure whose address is passed as theinf o 
parameter. 

struct CMMInf oRecord { 
OSType CMMType ; 

long CMMVersion; 

}; 
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typedef struct OiNTn f oRecordC ■ -InfoRecord; 

struct CWlnfoRecord { 

unsigned shortcaaaCount; 
CMMInf oRecordcnmxInfo [23 ; 

}; 

typedef struct CTInf oRecordCWInf oRecord; 



pascal 
CMError 

GetCWInfo (eWorld myCWorld, CWInfoRecord *info) ; 

PostScript support functions 

Three functions are added to the WhiteFang API and as optional functions in the 
CMM Component API to suppon color-matching by PostScript Level 2 devices. 

The flags parameter to these three function specifies the fomiat of the PostScript 
data to be returned. 

enum { 

ps7bifc = 1, 
psSbit = 2 

}; 



ps7bit specifies 7-bit ASCn 

ps Sbit specifies 8-bit per character data as specified in xh^PostScript Language 
Reference Manual second edition. 

GatPS2CoiorSpacd 

Return ASCn text usable as the parameter to the PostScripfeetcoiorspace 
operator. 

Tins operator characterizes the color space of subsequent graphics data. 

This function is dispatched to the CMM Component corresponding to 
srcProf . If the Component is not available or the function is not imple- 
mented then it is dispairhed to the default CMMtextData is set by the de- 
fault CMM and the funcdon result isrMMe thodNotFound. 

A caUer-supplied FlartenProc function is used to perform the actual data 
transfer. 

pascal 
CMError 

GetPS2ColorSpace {Profile srcProf, unsigned long flags, 
FlattenUPP proc, void *refCon) ; 
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Parameters 

srcProf (in) Reference to sourceProf ile. 

flags (in) specifies desired format of PostScript data 

proc (in) Function for data transfer 

refCon (in) Client data which is passed as a parameter to calls t(|>roc. 

Result codes 
noErr 

CMMet:hoc3NotFoundCMM corresponding tosrcProf not available. 
System or ColorSync result code if an error occurs. 



GetPS2ColorRond0ringIntent 

Return ASCII text usable as the parameter to the PostScripfeetRendering- 
Intent Operator. This operator specifies the color-matching option for sub- 
sequent graphics data. 

This function is dispatched lo die CMM Component corresponding to 
srcProf . If the Component is not available or the function is not imple- 
mented then it is dispatched to the default CMMtextData is set by the de- 
fault CMM and the function result is:::methodNotFound. 

A caller-supplied FlattenProc function is used to perform the actual data 
transfer. 

pascal 
CMEirx'or 

GetPS2ColorRenderingInT:ent (Prof ile srcProf, unsigned long 
flags , 

FlattenUPP proc, void *refCon) ; 

Parameters 

srcProf (in) Reference to sourccProf ile. 

flags (in) specifies desired format of PostScript data 

proc (in) Funcdon for data transfer 

refCon (in) Client data which is passed as a parameter to calls t(i)roc. 
Result codes 

noErr 

Os^MethodNotFoundCMM corresponding toprof not available. 
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System or ColorSync result code if an error occurs. 



GdtPS2CoforRondering 

Return ASCII text usable as the parameter to the PostScripfeetcolorRen- 
dering operator. This operator specifies the PostScript Color Rendering 
dictionary to be used for the following graphics data. 

This function is dispatched to the CMM Component corresponding to 
srcProf . If the Component is not available or the function is not imple- 
mented then it is dispatched to the default CMMtextData is set by the de- 
fault CMM and the function result is^yiMethodNotFound. 

A caller-supplied FlattenProc function is used to perform the actual data 
transfer. 

pascal 
CMError 

GetPS2ColorRenderiacr (Profile srcProf, Profile ds tProf, 

unsigned long flags, FlattenProc 

proc, 

void *refCon) ; 

Parameters 

srcProf (in) Reference to sourceProf iie. 
dstProf (in) Reference to destinationpro file- 
flags (in) specifies desired format of PostScript data 
proc (in) Function for data transfer 

refCon (in) CHent data which is passed as a parameter to calls t(|>roc. 

Result codes 

noErr 

CMMethodNotFoundCMM corresponding to prof not available. 
System or ColorSync result code if an error occurs. 
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CMWI Component Function Reference 

ACMM is a Component Manager Component. The standard required Component 
functions must be supported 

kComponentOpenSelect 

kComponentCloseSelect 

kComponentCanDoSelect 

kComponentVersionSelect 

The standard optional Component functions may also be supported 
kComponentRegisterSelect 
kComponentTargetSelect 

The dispatcher determines the CMM Components which will be responsible from 
the CMMType element of the?ro f lie parameters to the client call One or two 
CMMs perform the acmal work. 

A separate Componentlnstance is opened for each matching session.The set o§ro~ 
files is unique for each session. The Component should allocate private storage to 
store the necessary information for the instance and use Component Manager fimc- 
tions to manage the storage. A Component should free the storage in the Compo- 
nentClose function. 

The CMM Component functions are in either required or optional categories. For 
optional functions, the dispatcher will call the Component with the kComponent- 
CanDoSelect selector before calling the actual function. 

If the CMM does not support an optional function, the dispatcher will use an alter- 
native to complete the client request. For example, if the CMM does not support the 
CMMatchBitMap function, the dispatcher will convert the BitMap data tCMColor 
format and call the CMIvfciaiatchcoiors function. The matched colors will then 
be copied to the client BitMap. 

Requirad Functions 



NCMInit 

Component function called to initialize a matching session. Called after the 
Component has been opened with OpenComponent(...), 

pascal 
CMError 

NCMInit (Componentlnstance CMSession, Profile srcProfile, 
Profile dstProf ile) ; 

CMMatchColors 
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Color-matrhing on a list of CMColon The source and destination data types 
are specified by theProf ile parameters to the previous call to the NC- 
MInit(...). CMImt(...X or CMConcatImt(..0 function. 

pascal 
CMError 

CMMatchColors {Component Instance CMSession, 

CMColorliist myColors, long count) ; 

CMChackCotors 

Gamut test a list of CMColor. The source and destination are specified by 
the Profile parameters to the previous call to the NCMInit(...)» 
CMInit(...)» or CMConcatInit(..,) function. 

pascal 

CMError 

CMCheckColors (Component Instance CMSession, 

CMColorList myColors, long count, 
CMGainutResult result) ; 

CMValldateProfila 

Test whether Profile contains ±e minimum set of elements required by 
thisCMM. 

Third-party CMMs should first call ±e default CMM using Component 
Manager functions to assure that the minimum default elements are present 

pascal 
CMError 

CMValidateProf ile (Component Instance CMSession, Profile 
prof. 

Boolean *valid) ; 

CMFIattenProflld 

Flatten specifiedProf ile to ±e extemalcMProf ile format A caller-sup- 
plied FlattenProctJPP is called to perform the actual data transfer. The 
flags parameter specifies options for the content of the flattenedMPro- 
file. 

The default Apple implementation of this function must be capable of flat- 
tening any Prof ile which contains the minimum required elements- 
pascal 
CMError 

CMFlattenProf ile (Coxnponentlnstance CMSession, Profile 
prof, 

long flags, FlattenUPP proc, void *ref- 

Con) ; 
CMUnflatten P rofile 
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Unflatten an exxemal foimaKiMProf ile to an internal formatProf iie ref- 
erence. 

This function may be med to create aProf iie reference from acMProf iie 
embedded in a graphic document The caller is responsible for calling 
closeProf iie (-) when the use of the Profile reference is completed. 

The returned Pro file has a temporary backing file if necessary. The file is 
deleted at the time::ioseProf iie (_) is called, 

pascal 
CMError 

CMUnf lattenProf iie (Componentlnstance CJdSession, Profile 
'prof, 

FlactenUPP proc, void *refCon) 

Parameters 

CMSession(in)Reference to Componentlnstance, 

prof (out) Returns Pro file reference if function result isnoErr. 

Otherwise undefined. 

proc ' (in) Funcdon for data transfer 

refCon (in) Client data which is passed as a parameter to calls t<pToa, 

Resiilt codes 
noErr 

System or ColorSync result code if an error occurs 
Optional Functions 



CMMatchBitMap 

Match pixel data of bitMap according to th^rof iie parameters supplied 

to a previous call tOCMInit (^) , NCMInit {^) , or CMConcatlnit (-.) . 

pascal 
CMError 

CMMatchBitHap (Componentlnstance CMSession, const CMBitMap 
*bitMap, BitMapCallBackUPP progressProc, void *refCon, 

CilBitMap *inatchedBitMap) ; 

CMCheckBltfv/lap 

Gamut test pixel data of bitMap according to th^^rof iie parameters sup- 
plied to a previous call tOCMInit (..) » NCMXnit (-) , or CMConcatlnit (-) . 
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pascal 
CHError 

CMCheckBitMap (Component Ins tajice CMSess ion, const CMBitMap 
*bitMap, 

BitMapCallBackUPP progressProc , void *refCon, 
CMBitMap *resultBitMap) ; 

CMMatchPlxMap 

Match pixel data ofinyPixMap according to theProf ile parameters sup- 
plied to a previous call tOCMXnit (-> , NCMInit (-) , or CMConcatXnit (-.) , 

myPixMap is non-relocatablc. 

pascal 
CMError 

CMMatciiPixMap (Component Instance CMSession, PixMap *inyPix- 
Map, 

BitMapCallBackUPP progressProc . long refCon) ; 

CMChdckPixMap 

Gamut-test pixel data ofinyPixMap according to theProf ile parameters 
supplied to a previous call tocMinit («.) , NCMinit (-> , or CMConca- 
tinit {-.) . jnyPlxMap is non-relocatable.. 

pascal 
CMError 

CMCheckPixMap (Conconent Instance CMSession, PixMap *rayPix- 

Map, 

BitMapCallBacktrPP progressProc, BitMap *n!y- 

BitMap, 

long refCon) ? 

CMConcatlnit 

This is a special purpose function that is outside the domain of the standard 
source -> destination matching session. A single CMM is specified by the 
caller which is responsible for the entire session. That CMM may use Com- 
ponent Manager functions to call other CMMs if required. 

The processing possible with this ftmcdon can be complex, including oper- 
ations outside of simple "matching". 

Note thattfaedataType and deviceType of the first and lastProf iles must 
be valid device values, Intermediateprof iles may be non-device type val- 
ues. 

pascal 
CMError 

CMConcatXnit ( C oinp o n en t Instance CMSession, 

ConcatProf ileSet *profileSet) ; 

Parameters 
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CMSession(in)Reference to Componentlnstaiice. 

profileSet(in) ConcatProf ileset contains an array of Prof iles which 

describe the processing to be carried out 

Theprrof ileSet array is in processing or- 
der — Source through Destination. A mini- 
mum of one Profile must be specified. 

The CMMType element of Prof ile at keyln- 
dex specifies this CMM, which is entirely re- 
sponsible for the session. 

struct ConcatProf ileSet 
( 

unsigned shortkeylndex ; 
unsigned shortcount; 
Profile prof ileSet [ 1 ] ; 

}; 

Result codes 
noErr 

System or ColorSync result code if an error occurs. 

CMNewUnkProfiie 

This function allows the creation of a newprof ile which embodies the 
transforms included byNc;"JConcatcoiorWorld(-.). 

Note that thedataType and deviceType of the first and lastProf iles must 
be valid device values. Intermediatepro files may be non-device type val- 
ues. 

pascal 
CMError 

CMNewIiinkPro file (Coraponent Instance CMSession, Profile 
*prof , 

const FSSpec *backingFileSpec , 
ConcatProf ileSet *prof ileSet) ; 

Parameters 

CMSession(in)R£ference to Componentlnstance. 

backingFileSpec (in)File spec for the resultingCMProf ile. 

profileSetCin) ConcatProf iieSet contains an array ofProf iles which 

describe the processing to be carried out 

The prof ileSet array is in processing or- 
der — Source through Destinanon. A mini- 
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mum of one Profile is required. 

The CMMType element of Pro f i l e at key in- 
dex specifies the CMM which is entirely re- 
sponsible for the session. 

Result codes 
noErr 

System or ColorSync result code if an error occurs. 
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CMGetPS2CoiorSpaca 

Retxim ASCn text usable as the parameter to the PostScripfeetcolorspace 
operator. 

This operator characterizes the color space of subsequent graphics data. 

A caller-supplied FlattenProc function is used to perform the actual data 
transfer. 

pascal 
CMError 

CMGetPS2ColorSpace (Component Instance CMSession, Profile 
srcProf, unsigned long flags, FlattenUPP proc, 

void *refCon) ; 

Parameters 

CMSession(in)Reference to Componentlnstance. 

srcProf (in) Reference to source Profile. 

flags (in) specifies desired format of PostScript data 

proc (in) Function for data transfer 

refCon (in) Client data which is passed as a parameter to calls tQsroc 
Result codes 

noErr 

System or ColorSync resxilt code if an error occurs. 

CMGetPSaCoIorRenderinglntent 

Return ASCII text xisable as the parameter to the PostScript et Render ing- 
intent operator. This operator specifies the color-matching option for sub- 
sequent graphics data. 

A caHer-suppIied FlattenProc function is used to perform the actual data 
transfer. 

pascal 
CMError 

CMGetPS2ColorRenderingIntent (Componentlnstance CMSess ion, 

Profile srcProf, 
tmsigned long flags, 
FlattenUPP proc, void *ref- 

Con) ; 

Parameters 
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CMSession(in)Referencs to ComponeiitInstar.c^i. 
srcProf (in) Reference to source Profile, 
flags (in) specifies desired fonnat of PostScript data 
proc (in) Function for data transfer 

refCon (in) Client data which is passed as a parameter to calls tQ^roc. 

Result codes 
noErr 

System or ColorSync result code if an error occurs. 
CMGatPS2ColorRendering 

Return ASCII text usable as the parameter to the PostScripfeetcolorRen- 
dering Operator. This operator specifies the PostScript Color Rendering 
dictionary to be used for subsequent graphics data. 

A caller-supplied FlattenProc function is used to perform the actual data 
transfer. 

pascal 

CMError . 
CMGetPS2ColorRendering{ComponentInstance CMSessxon, Pro- 
file srcProf, ^ . J n 

Profile dstProf, unsigned long 

flags, FlattenUPP proc, void *refCon) ; 

Parameters 

CMSession(ia)Reference to Componentlnstance. 

srcProf (in) Reference to source profile. 

dstProf (in) Reference to destmatibnprof iie. 

flags (in) specifies desired foraiat of PostScript data 

proc (in) Function for data transfer 

refCon (in) Client data which is passed as a parameter to calls t(S)roc. 

Result codes 
noErr 

System or ColorSync result code if an error occurs 
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What Is Claimed Is: 

L In a color manageTnent system providing a modular framework 
having a default color matching module and in which color matching modules 
may be added to and removed from the system, a method of selecting and using 

5 one or more color matching modules to perform a requested color matching 
operation of source data specified in a source data space described by a source 
profile and destination data specified in a destination data space described by a 
destination profile, the source profile identifying a designated 
source-profile-preferred color matching module and the destination profile 

10 identifying a designated destination-profile-preferred color matching module, the 
method comprising the steps of: 

a) if the source profile preferred color matching module is unavailable, 
designating instead a default color matching module as the designated 
source-profile-preferred color matching module for purposes of selection, 

15 and if the destination profile preferred color matching module is 

unavailable, designating instead a default color matching module as the 
designated destination-profile-preferred color matching module for 
purposes of selection, 

b) if following step a) the designated source-profile-preferred color 
20 matching module and the designated destination-profile-preferred color 

matching module are the same color matching module, using said same 
color matching module to build a concatenated transformation table by 
sampling color points in a source color space specified in the source 
profile and converting the sampled color points into a destination color 
25 space specified in the destination profile, and converting colors from the 

source color space to the destination color space by table lookup using 
the concatenated transformation table; else 

c) if following step a) the designated source-profile-pref erred color 
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matching module and the designated destination-profile-preferred color 
matching module are different, using the designated 
source-profile-preferred color matching module and the designated 
destination-profile-preferred color matching module to build a 

5 concatenated transformation table by sampling color points in a source 

color space specified in the source profile and converting the sampled 
color points into a destination color space specified in the destination 
profile, and converting colors from the source color space to the 
destination color space by table lookup using the concatenated 

10 transformation table, 

2. The method of Claim 1 , wherein the designated 
source-profile-preferred color matching module and the designated 
destination-profile-preferred color matching module use a common color 
interchange space, step c) further comprising: 

J 5 converting the source data to data in the common color 

interchange space using the designated source-profile-preferred color matching 
module; and 

converting the data in the common color interchange space to 
destination data using the designated destination-profile-preferred color matching 
20 module. 

3. The method of Claim 1, wherein the designated 
source-profile-preferred color matching module and the designated 
destination-profile-preferred color matching module use different color 
interchange spaces, step c) further comprising: 

25 converting the source data to data in the source color interchange 

space using the designated source-profile-preferred color matching module; 

converting the data in the source color interchange space to a 
destination color interchange space using a color space conversion function; and 
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converting the data in the data color interchange space to 
destination data using the designated destination-^profile-preferred color matching 
module. 

5 4. In a color management system providing a modular framework 

having a default color matching module and in which color matching modules 
may be added to and removed from the system, a method of validating color 
profiles describing color characteristics of color images or devices, comprising 
the steps of: 

10 accessing the profile to identify a preferred color matching 

module; 

if the preferred color matching module is available, dispatching 
the preferred color matching module to perform validation of the profile; and 
if the preferred color matching module is not available, 
15 dispatching a default color matching module to perform validation of the profile. 

5. In a color management system providing a modular framework 
having a default color matching module and in which color matching modules 
may be added to and removed from the system, a method of converting data in 
20 a color profile designating a prefenred color matching module to color profile 
PostScript data, comprising the steps of: 

if the preferred color matching module is available, dispatching the 
preferred color matching module to convert the non-PostScript data to PostScript 
data; and 

25 if the preferred color matching module is not available, dispatching a 

default color matching module to convert the non-PostScript data to PostScript 
data. 

6. In a color management system providing a modular framework 
having a default color matching module and in which color matching modules 
30 may be added to and removed from the system, a method of creating a 
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concatenation of color profiles describing color characteristics of color devices, 
comprising the steps of: 

designating one of the color profiles as a key profile, the key profile 
containing data identifying a preferred color matching module; 
5 if the preferred color matching module is available, dispatching the 

preferred color matching module to perform the concatenation of the color 
profiles; and 

if the preferred color matching module is not available, dispatching a 
default color matching module to perform the concatenation of the color 
10 profiles. 

7. In a color management system providing a modular framework 
having a default color matching module and in which color matching modules 
may be added to and removed from the system, a method of creating a 
concatenation of a sequence of color profiles, including a first source profile and 
15 a last destination profile, describing color characteristics of color devices, each 
of the color profiles identifying a designated profile-preferred color matching 
module, the method comprising the steps of: 

if a designated profile-preferred color matching module is unavailable, 
designating instead a default color matching module as the designated 
20 profile-preferred color matching module; and 

building a concatenated transformation table by sampling color points in 
a source color space specified in a first profile and converting the sampled color 
points into a final color space specified in a final profile using the designated 
profile-preferred color matching modules by: 
25 for a first color profile, converting color profile information from 

a source profile color space to a color interchange space using a 
corresponding designated profile-preferred color matching module; 

for each successive color profile before a last color profile, 
converting from a color interchange space of a preceding color matching 
30 module to a color interchange space of a present color matching module 
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if the color interchange space of the preceding color matching module 
and the color interchange space of the present color matching module are 
different, converting from the color interchange space of the present 
color matching module to a color profile space of the present color 

5 matching module using a corresponding designated profile-preferred 

color matching module, and converting from the color profile space of 
the present color matching module to a color interchange space of the 
present color matching module using said corresponding designated 
profile-preferred color matching module; and 

10 for a last color profile, converting from a color 

interchange space of a preceding color matching module to a 
color interchange space of the last color matching module if the 
color interchange space of the preceding color matching module 
and the color interchange space of the last color matching module 

15 are different; and 

converting from the color interchange space of the last color 
matching module to a color profile space of the last color matching 
module using a corresponding designated profile-preferred color 
matching module and converting colors from the first color space to the 

20 last color space by table lookup using the concatenated transformation 

table. 

8. In a color management system providing a modular framework 
having a default color matching module and in which color matching modules 
may be added to and removed from the system, a method of creating a device 
25 link profile describing an overall color characteristic of multiple color devices, 

comprising the steps of : 

if a designated profile-preferred color matching module is unavailable, 
designating instead a default color matching module as the designated 
profile-preferred color matching module; and 
30 building a concatenated transformation table by sampling color points in 
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a source color space specified in a first profile and converting the sampled color 
points into a final color space specified in a final profile using the designated 
profile-preferred color matching modules bj': 

for a first color profile, converting color profile information from a 

5 source profile color space to a color interchange space using a corresponding 
designated profile-preferred color matching module; 

for each successive color profile before a last color profile, converting 
from a color interchange space of a preceding color matching module to a color 
interchange space of a present color matching module if the color interchange 

10 space of the preceding color matching module and the color interchange space 
of the present color matching module are different, converting from the color 
interchange space of the present color matching module to a color profile space 
of the present color matching module using a corresponding designated 
profile-preferred color matching module, and converting from the color profile 

15 space of the present color matching module to a color interchange space of the 
present color matching module using said corresponding designated 
profile-preferred color matching module; and 

for a last color profile, converting from a color interchange space of a 
preceding color matching module to a color interchange space of the last color 

20 matching module if the color interchange space of the preceding color matching 
module and the color interchange space of the last color matching module are 
different, and converting from the color interchange space of the last color 
matching module to a color profile space of the last color matching module 
using a corresponding designated profile-preferred color matching module; and 

25 creating a new color profile including the concatenated transformation 

table. 
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